From 8219a413ff663825672e773d1537594706b16122 Mon Sep 17 00:00:00 2001 From: Christian Persch Date: Mon, 12 Sep 2011 01:21:04 +0200 Subject: [PATCH] Clarify conditions when get_font_{family,face} return NULL --- gtk/gtkfontchooser.c | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/gtk/gtkfontchooser.c b/gtk/gtkfontchooser.c index ed60f435b0..3abfb697be 100644 --- a/gtk/gtkfontchooser.c +++ b/gtk/gtkfontchooser.c @@ -136,8 +136,10 @@ gtk_font_chooser_default_init (GtkFontChooserInterface *iface) * Gets the #PangoFontFamily representing the selected font family. * Font families are a collection of font faces. * + * If the selected font is not installed, returns %NULL. + * * Return value: (transfer none): A #PangoFontFamily representing the - * selected font family. The returned object is owned by @fontchooser + * selected font family, or %NULL. The returned object is owned by @fontchooser * and must not be modified or freed. * * Since: 3.2 @@ -157,8 +159,10 @@ gtk_font_chooser_get_font_family (GtkFontChooser *fontchooser) * Gets the #PangoFontFace representing the selected font group * details (i.e. family, slant, weight, width, etc). * + * If the selected font is not installed, returns %NULL. + * * Return value: (transfer none): A #PangoFontFace representing the - * selected font group details. The returned object is owned by + * selected font group details, or %NULL. The returned object is owned by * @fontchooser and must not be modified or freed. * * Since: 3.2 -- 2.30.2